What this PR does:

1. Change Span from a struct to an interface.
2. Add a Tracer interface
3. Add an implementation of the Tracer interface using the existing Tracer functions (StartSpan, StartSpanWithRemoteParent, FromContext, and WithContext)
4. Add a global DefaultTracer variable that can be set by users, and defaults to the existing Tracer implementation.
5. Add accessors for Key and Value for Attributes

Motivation for the PR:

We would like to be able to assist users in their migration to OpenTelemetry. One way to do this is by writing an implementation of OpenCensus APIs which uses OpenTelemetry under the hood. This way, OpenCensus spans with an OpenTelemetry parent (or vice-versa) would be linked, and all telemetry would be exported through the same exporters (OpenTelemetry exporters in this case).

Rationale for the PR:

This adopts a similar model to OpenTelemetry, in which the SDK can be swapped out for a different implementation.

User Impact:

For users using the "typical" workflow, there should be no changes. For example,

ctx, span := trace.StartSpan(ctx, "OpenCensusSpan")
span.End()

still functions the same way. Even though the Span struct was changed to an interface, the same methods still exist. Only users that pass Spans would need to change when updating:

// Before this change
func main() {
    ctx, span := trace.StartSpan(ctx, "OpenCensusSpan")
    endSpan(span)
}
func endSpan(s *Span) {
    s.End()
}

// After this change
func main() {
    ctx, span := trace.StartSpan(ctx, "OpenCensusSpan")
    endSpan(span)
}
func endSpan(s Span) {
    s.End()
}

notice the *Span was changed to Span

This change also impacts the evaluation of Span against nil. For example,

// Before this change
span := trace.FromContext(ctx)
if span != nil {
    // do something
}

The above will no longer function as expected. This is because nil, when assigned to an interface, makes the interface non-nil: https://play.golang.org/p/BWutROXBt5y. Users should change to the following:

// After this change
span := trace.FromContext(ctx)
if span.IsRecordingEvents() {
  // do something
}

Example Usage:

See https://github.com/dashpole/opencensus-migration-go/tree/replace_oc_sdk#opencensus-migration-go for an overview, and https://github.com/dashpole/opencensus-migration-go/tree/replace_oc_sdk/migration for an implementation of the new Tracer and Span APIs.

@nilebox @jsuereth @james-bebbington